home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / wavepool.zip / WAVEPOOL.DOC < prev    next >
Text File  |  1992-04-08  |  9KB  |  244 lines
  1.  
  2.  
  3.                                   WAVEPOOL
  4.                                Version: 1.0-A
  5.                                   04/08/92
  6.  
  7.  
  8.      Copyright (c) 1992, Data Assist Inc., All Rights Reserved.
  9.  
  10.                                 INTRODUCTION
  11.  
  12.      WAVEPOOL is a programming language, similar to "C", designed for
  13.      creating sound files. By using built-in WAVEPOOL functions, you
  14.      can easily synthesize new sounds effects.
  15.  
  16.      Since WAVEPOOL runs as an interpreter, you are able to quickly
  17.      make changes and experiment with creating sound effects. The
  18.      possible sounds effects generated are limited only by your
  19.      imagination!
  20.  
  21.      The sound files created by WAVEPOOL are compatible with the Sound
  22.      Blaster card. Various utility programs are available that can be
  23.      used to convert SOU and VOC files to other sound file formats.
  24.  
  25.      Although WAVEPOOL runs under DOS, the package can be used to
  26.      create WAV files that are compatible with the Windows 3.1 Multi-
  27.      Media sound format by using the VOC2WAV program.
  28.  
  29.      Wavepool can also be ran from the Windows MS-DOS or RUN prompts.
  30.  
  31.  
  32.                                 REGISTRATION
  33.  
  34.      WAVEPOOL Registration: $35 (Updated version will be sent)
  35.  
  36.      The updated version will contain more functions and additional
  37.      waveforms. We are also adding an amplitude envelope feature.
  38.  
  39.      If you have enjoyed using WAVEPOOL, Please register. If you are
  40.      using WAVEPOOL to create sound effects for distribution, then
  41.      you MUST register the program. We think this is a fair policy!
  42.  
  43.      Registered users will also be granted higher access to our BBS,
  44.      and entered into our drawing. See DRAWING information below.
  45.  
  46.      Print the file ORDER.DOC for a registration form.
  47.  
  48.  
  49.                                  TRADEMARKS
  50.  
  51.      WAVEPOOL is a trademark of Data Assist, Inc.
  52.      Sound Blaster is a trademark of Creative Labs, Inc.
  53.      Windows is a trademark of Microsoft Corp.
  54.  
  55.  
  56.  
  57.                             GENERAL INFORMATION
  58.  
  59.      WAVEPOOL stands for "WAVE Programmable Output Oriented Language."
  60.  
  61.      With the release of Windows 3.1 and the ability to attach WAV
  62.      files to events, everybody is now looking for interesting sound
  63.      effects. However, Windows does not provide a facility to create
  64.      WAV files other than recording them via a supported sound card.
  65.  
  66.      WAVEPOOL was originally created as an "in-house" tool to create
  67.      sound effects for some of our other software products. Due to the
  68.      large demand for WAV files, we have decided to release this tool
  69.      as a Shareware utility. We have many additions in mind for
  70.      WAVEPOOL. Your registration will support these improvements.
  71.  
  72.      An advantage of using WAVEPOOL to create sounds is that WPL files
  73.      are very small compared to the SOU, VOC and WAV files that are
  74.      generated. As such, WAVEPOOL files can quickly be uploaded and
  75.      downloaded from BBS systems.
  76.  
  77.  
  78.                           PROGRAMS AND SOUND FILES
  79.  
  80.      WAVEPOOL programs may be edited using any standard DOS text
  81.      editor. A WAVEPOOL program file has a '.WPL' file extension.
  82.  
  83.      The sound data files (.SOU) created by WAVEPOOL are in a raw (no
  84.      header) format. This format was chosen because raw data files
  85.      are better for the additional features that we have planned.
  86.  
  87.      Use the internal SNDVOC function to convert SOU files into Sound
  88.      Blaster compatible VOC files. Until a SNDWAV function is added to
  89.      WAVEPOOL, you must first create a VOC file and then use the
  90.      VOC2WAV program to create a Windows compatible sound file.
  91.  
  92.      The SOU files created by WAVEPOOL have a sampling rate of 11,000
  93.      samples per second. You should take this into account when
  94.      converting the SOU files to other sound file formats.
  95.  
  96.  
  97.                                    USAGE
  98.  
  99.      WAVEPOOL is executed under DOS by entering WPL followed by the
  100.      program name.
  101.  
  102.      Example:
  103.  
  104.      C> WPL BIRD
  105.  
  106.      In this example the program BIRD will be read in and executed.
  107.  
  108.  
  109.  
  110.                                  STATEMENTS
  111.  
  112.      A statement can be one of the following:
  113.  
  114.           { STATEMENT_LIST }
  115.           EXPRESSION
  116.           print EXPRESSION-LIST
  117.           printf FORMAT, EXPRESSION_LIST
  118.           if ( EXPRESSION ) STATEMENT [ else STATEMENT ]
  119.           for ( EXPRESSION; EXPRESSION; EXPRESSION) STATEMENT
  120.           while ( EXPRESSION ) STATEMENT
  121.           do STATEMENT while ( EXPRESSION )
  122.           break
  123.           continue
  124.           exit [ EXPRESSION ]
  125.           function NAME ( VARIABLES ) { STATEMENT_LIST }
  126.           return [EXPRESSION ]
  127.  
  128.      A STATEMENT_LIST is a list of statements separated by newlines or
  129.      semicolons.
  130.  
  131.      Expressions take on  string or  numeric values depending  on the
  132.      operators.  There is only  one  string operators  concatenation,
  133.      indicated by adjacent expressions.
  134.  
  135.                                  OPERATORS
  136.  
  137.      The following are the operators in order of increasing precedence:
  138.  
  139.      Operation           Operator      Example
  140.  
  141.      assignment          = *= /= %=    x += 2
  142.                          += -= ^=
  143.      conditional         ?:            x?y:z
  144.      logical OR          ||            x||y
  145.      logical AND         &&            x&&y
  146.      relational          == != >       x==y
  147.                          <= >= <
  148.      concatenation                     "x" "y"
  149.      add, subtract       +  -          x+y
  150.      mul, div, mod       * / %         x*y
  151.      unary plus minus    + -           -x
  152.      logical not         !             !x
  153.      exponentiation      ^             x^y
  154.      inc, dec            ++ --         x++
  155.  
  156.  
  157.  
  158.                          MATH AND STRING FUNCTIONS
  159.  
  160.      Function           Value returned
  161.  
  162.      atan2(y, x)        arctangent of y/x (from -PI to PI)
  163.      cos(x)             cosine of x (x in radians)
  164.      exp(x)             exponentiation of x (e ^ x)
  165.      index(s, t)        position of t in s (0 if not in s)
  166.      int(x)             integer part of x
  167.      length(s)          number of characters in s
  168.      log(x)             natural log of x
  169.      rand()             random number (0 <= rand < 1)
  170.      sin(x)             sine of x (x in radians)
  171.      sprintf (...)      formatted string
  172.      sqrt(x)            square root of x
  173.      substr(s,p)        substring of s from p to end
  174.      substr(s,p,n)      substring of s from p of length n
  175.  
  176.  
  177.                           SOUND RELATED FUNCTIONS
  178.  
  179.      Function           Action
  180.  
  181.      screate(s)         create a SOUnd format output file.
  182.      sclose(n)          close the current file. if n==0 close output.
  183.      sndvoc(s,p)        convert a SOUnd file to VOC file.
  184.      sinwave(f,n)       generate a sine wave; f=frequency, n=samples
  185.      sinwave2(f,g,n)    generate a sine wave; f->g, n=samples.
  186.      quiet(n)           generate silence, n=samples
  187.  
  188.  
  189.                                  VARIABLES
  190.  
  191.      Variables may be scalars. Array elements are not yet supported in
  192.      this version of WAVEPOOL.
  193.  
  194.      Variable names begin with a letter or underscore and may contain
  195.      any number of letters, digits, or underscores.
  196.  
  197.      Before any value is assigned to a variable it's type is
  198.      indeterminate, that is it is both a string and a number (this is
  199.      important when doing comparisons and for printing). An
  200.      uninitialized variable will compare equal to the null string ("")
  201.      and to zero (0). It will print as the null string.
  202.  
  203.  
  204.  
  205.                            APPLICATION NOTES
  206.  
  207.      To use WAVEPOOL VOC files with Windows 3.1, you must convert
  208.      the VOC file to a WAV file using the VOC2WAV.EXE program.
  209.      VOC2WAV is available on Exec-PC, CompuServe and on our BBS.
  210.  
  211.      To use WAVEPOOL SOU files with Grasp, you must convert the
  212.      SOU file to a Grasp style SND file by using the MAC2SND.EXE
  213.      program distributed with Grasp.
  214.  
  215.  
  216.                                DRAWING
  217.  
  218.      All users who register WAVEPOOL before December 31, 1992 will
  219.      automatically be entered in our drawing.  The winner will be
  220.      given a copy of RECORDING STUDIO PROFESSIONAL, by Turtle Beach
  221.      Systems, distributed by Brown/Wagh Publishing, Value: $199.
  222.  
  223.      Simply register WAVEPOOL before December 31, 1992 and you
  224.      will automatically be entered into our drawing!
  225.  
  226.  
  227.                        UPDATES AND TECH SUPPORT
  228.  
  229.      For more information about updates, or our other software
  230.      products, please call or write:
  231.  
  232.                 Data Assist, Inc.
  233.                 P. O. Box 26114
  234.                 Columbus, OH  43226
  235.  
  236.                 Tel: 614-888-8088
  237.                 BBS: 614-888-8056
  238.  
  239.      Note: Please do NOT call for technical support unless you have
  240.      registered this program with Data Assist.  Purchase of this
  241.      program from a Shareware vendor does NOT mean you are registered!
  242.  
  243.  
  244.